home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / X11 / Fresco / build / Unix / README < prev   
Text File  |  1995-07-12  |  5KB  |  120 lines
  1.  
  2. To build Fresco on a UNIX system using Imake...
  3. ______________________________________________________________________
  4.  
  5. 1.  Unpack the tar file on a filesystem with at least 50 MB of free
  6.     disk space.  This is the grand total of the disk space that the
  7.     fully built and installed source tree will occupy.  Let us call
  8.     the top of the source tree (the directory containing the Copyright
  9.     file) $FRESCO.
  10.  
  11. 2.  Copy a site.def file into the $FRESCO/build/Unix/config/cf
  12.     directory.  We've provided a sample site.def, $FRESCO/site.def,
  13.     that is set up for Solaris 2.x with Sun's C++ compiler.  You can
  14.     modify it as you see fit or provide your own site.def. There
  15.     are versions of site.def available for a certain platforms in the
  16.     directory://ftp.faslab.com/pub/Fresco/BldNotes
  17.  
  18.     Your compiler must be able to find the X11 headers and libraries
  19.     somewhere on your system since Fresco is no longer a part of the
  20.     X11 source tree.  Set either ProjectRoot or BinDir, IncDir,
  21.     LibDir, ManDir, and UsrLibDir if your compiler can't find them by
  22.     default.
  23.  
  24.     If you want to build Dish (Fresco's Tcl-based script interpreter),
  25.     then you'll also have to set TclIncludes and TclPreLib if tcl.h or
  26.     libtcl.a aren't installed in the default locations searched by
  27.     your compiler.
  28.  
  29.     Once you've written a site.def for your platform, copy it to
  30.     $FRESCO/build/Unix/config/cf as follows:
  31.  
  32.       % cp site.def $FRESCO/build/Unix/config/cf/site.def
  33.  
  34.     IMPT: When you build Fresco, you'll be using Fresco's config files
  35.     in $FRESCO/build/Unix/config/cf.  Please don't attempt to use your
  36.     system's X11 config files, as this will lead to problems when
  37.     building.  This can happen if you accidentally type "xmkmf"
  38.     instead of "make Makefile".  Deleting $FRESCO/build/Unix/Makefile
  39.     and saying
  40.  
  41.       % cd $FRESCO/build/Unix
  42.       % make -f Makefile.ini Makefiles BOOTSTRAPCFLAGS=<...>
  43.  
  44.     will always rebuild all the Makefiles correctly.
  45.  
  46. 3.  Check the appropriate $FRESCO/build/Unix/config/cf/vendor.cf
  47.     (sgi.cf, sun.cf, etc.) to make sure that OSMajorVersion and
  48.     OSMinorVersion are set correctly for your system (change them if
  49.     necessary).
  50.  
  51.     Also check if there is a BootstrapCFlags mentioned in the
  52.     vendor.cf file.  If there is one, you must set BOOTSTRAPCFLAGS to
  53.     its value when saying "make World" or "make Makefiles".  If you
  54.     have ever built X11 on your system, use the same value for
  55.     BOOTSTRAPCFLAGS that you used then.
  56.  
  57.     If you plan to build Fresco on only one system, you may want to
  58.     set BOOTSTRAPCFLAGS in $FRESCO/Makefile so you won't have to
  59.     remember to set it on the command line when saying "make World" or
  60.     "make Makefiles".
  61.  
  62. 4.  "Make the world" with the proper bootstrap flags for your system: 
  63.     First, cd to the Unix build directory:
  64.  
  65.       % cd $FRESCO/build/Unix
  66.  
  67.     Initially, you will have no Makefile in this directory,
  68.     create one as follows:
  69.  
  70.       % make -f Makefile.ini BOOTSTRAPCFLAGS=-DSVR4      (Solaris 2.x)
  71.  
  72.     Make the world:
  73.  
  74.       % make World
  75.  
  76.     If something goes wrong, try to fix the problem and then restart
  77.     the appropriate stage of the build by saying "make Makefiles",
  78.     "make depend", or "make all" until the build completes
  79.     successfully.
  80.  
  81.     If your Makefile in $FRESCO/build/Unix ever gets out of whack
  82.     so you can no longer make, you can fix it by removing the
  83.     Makefile and saying
  84.  
  85.       % make -f Makefile.ini BOOTSTRAPCFLAGS=-DSVR4      (Solaris 2.x)
  86.  
  87.     as shown above.
  88.  
  89.     If you cannot build the ixx interface translator during "make depend",
  90.     simply create an empty file,
  91.  
  92.       % touch $FRESCO/build/Unix/bin/ixx
  93.  
  94.     to make the build continue without trying to build ixx.  You do
  95.     not need a working ixx to build Fresco unless you modify one of
  96.     the .idl interface files; the .h and .cxx files are already
  97.     generated for you.
  98.  
  99. 5.  If the build completes successfully, you can start using Fresco
  100.     immediately.  Fresco is designed to be built and used completely
  101.     in place.  Simply include the bin and lib directories in your PATH
  102.     and LD_LIBRARY_PATH.  For example, on Solaris 2.x we do:
  103.  
  104.       % setenv PATH $PATH:$FRESCO/build/Unix/bin
  105.       % setenv LD_LIBRARY_PATH $LD_LIBRARY_PATH:$FRESCO/build/Unix/lib
  106.  
  107. 6.  Try out the examples:
  108.  
  109.       % cd $FRESCO/build/Unix/examples
  110.       % ./hello
  111.  
  112. 7.  Try out dish:
  113.  
  114.       % cd $FRESCO/Fresco/examples/dish
  115.       % dish fdemo
  116.  
  117. 8.  Try out fdraw:
  118.  
  119.       % fdraw
  120.